home *** CD-ROM | disk | FTP | other *** search
/ FishMarket 1.0 / FishMarket v1.0.iso / fishies / 301-325 / disk_309 / sksh / miscinfo.doc < prev    next >
Text File  |  1992-05-06  |  6KB  |  199 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.                         Misc. Information (bug reports, etc)
  17.  
  18.                                         SKSH
  19.  
  20.                            A ksh-like Shell for the Amiga
  21.  
  22.                                      Version 1.3
  23.  
  24.  
  25.                                (Copyright) 1989, 1990
  26.  
  27.                                      Steve Koren
  28.  
  29.                                    January 2, 1990
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.           Reporting Bugs
  74.  
  75.             Bug reports (as well as other inquiries) may  be  sent  to  the
  76.             following US Mail address:
  77.  
  78.                Steve Koren
  79.                4501 Boardwalk Dr.
  80.                Apt D-38
  81.                Fort Collins, CO 80525
  82.  
  83.             Or reported by phone:
  84.  
  85.                (303) 226-4985
  86.  
  87.             You can also use the following email address,  which  tends  to
  88.             change less often than the US mail address:
  89.  
  90.                koren@hpfela.HP.COM
  91.  
  92.             In any case, please  read  the  rest  of  this  section  before
  93.             reporting bugs.   Also,  please  understand  that  I  can  only
  94.             answer inquiries of any sort during my free (non-work) time.
  95.  
  96.             First of all, try to be sure that what  you  are  reporting  is
  97.             really a bug and not just  a  misunderstanding  on  your  part.
  98.             For example, perhaps you cannot get local  variables  to  work.
  99.             It turns out  that  there  are  ways  in  SKsh  to  turn  local
  100.             variables off  entirely  or  change  their  behavior  from  the
  101.             default.  If you are not aware  of  this,  you  might  have  an
  102.             option set that you mistake for improper behavior.   In  short,
  103.             read all the documentation  first,  even  if  you  already  are
  104.             familiar with Unix shells.  SKsh is not  sh or ksh.  Also, make
  105.             sure you have enough memory, stack space, etc, and verify  that
  106.             you have correctly performed all the steps in the  installation
  107.             guide.
  108.  
  109.             If you suspect that your problem is really a bug, then  do  the
  110.             following.  Duplicate the  bug  on  an  unmodified  version  of
  111.             SKsh.  This should include  the  distribution  version  of  the
  112.             .skshinit  and  .skshrc  files,  as  well   as   an   original,
  113.             unmodified SKsh binary.  Then, if possible,  generate  a  small
  114.             test script or function that you believe is correct, but  which
  115.             produces improper results.  Send it to me by one of  the  above
  116.             methods.  I will then examine it, determine if it is  really  a
  117.             bug, and if so, how, when and if I might  fix  it.   Except  in
  118.             unusual circumstances,  I  will  probably  not  distribute  bug
  119.             fixes on a case by  case  basis.   Rather,  I  will  accumulate
  120.             several and distribute a new version of SKsh.
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.           SKSH Amiga Shell             Page 2            Misc. Information
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.           Obtaining the Latest SKsh
  140.  
  141.             I distribute SKsh in several ways.   I  will  send  it  to  the
  142.             moderator of comp.binaries.amiga for posting  there.   This  is
  143.             probably the best and fastest way to obtain  new  versions.   I
  144.             will probably send a copy off to Fred Fish, although  I  assume
  145.             there will be a delay before  it  appears  in  his  collection.
  146.             Also, I will send  SKsh  to  several  BBS  systems  around  the
  147.             country, from which it tends to propagate.
  148.  
  149.             If you wish to  know  the  latest  version  of  SKsh,  you  may
  150.             contact me.  However,  except  under  unusual  circumstances  I
  151.             will simply tell you how to get the latest version  instead  of
  152.             actually sending it to you directly (unless  perhaps  you  send
  153.             me a self-addressed stamped mailer and a disk).
  154.  
  155.             If you do contact me  by  US  Mail  (I  prefer  email),  please
  156.             include a  self-addressed  stamped  envelope  or  postcard.   I
  157.             reply to *all* inquiries,  but  my  last  large  Amiga  project
  158.             (QRT) generated several hundred US  Mail  inquiries  (and  even
  159.             more email inquiries).  It is much more convenient  for  me  if
  160.             you include a self-addressed envelope.  Thanks!
  161.  
  162.             Also, QRT generated countless requests for  IBM  versions,  Mac
  163.             versions, etc.  QRT did run on those  systems,  but  SKsh  does
  164.             not.  SKsh is written with machine independence  in  mind,  and
  165.             the port should not be difficult,  but  I  personally  have  no
  166.             interest in PC or Mac versions, so I  will  not  be  doing  any
  167.             ports.  If SKsh is ported to other systems, please contact  the
  168.             author of the port for information.  As of  SKsh  1.3,  I  have
  169.             not released source code.  I may for future  versions,  when  I
  170.             have a chance to better comment the source.
  171.  
  172.  
  173.           Where to go for Help
  174.  
  175.             If you do not understand something about SKsh, the first  place
  176.             to go is of course the manual.  If you still cannot  figure  it
  177.             out, you  might  try  asking  a  knowledgeable  sh or ksh user.
  178.             Even though SKsh is not identical to those shells, it is  close
  179.             enough that someone familiar  with  ksh could probably read and
  180.             understand an SKsh script easily.
  181.  
  182.             If all else fails, you can contact  me  by  one  of  the  above
  183.             methods.  I can probably help :-).
  184.  
  185.             Finally, I wish to express my  appreciation  for  those  people
  186.             who have taken the time  to  make  comments,  suggestions,  and
  187.             point out bugs.  SKsh will be a better program as a result.
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.           SKSH Amiga Shell             Page 3            Misc. Information
  196.  
  197.  
  198.  
  199.